<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML LANG="EN-US">
<HEAD>
<TITLE>VT100.net: VT330/VT340 Programmer Reference Manual</TITLE>
<LINK HREF="vt330.css" TYPE="text/css" REL="stylesheet">
</HEAD>
<BODY>
<DIV CLASS="navbar"><A HREF="http://vt100.net/"><IMG CLASS="button" SRC="vt100.net-logo.png" ALT="VT100.net" HEIGHT="16" WIDTH="102"></A> VT330/VT340 Programmer Reference Manual Volume 2: Graphics Programming<TABLE WIDTH="100%">
<COL SPAN="3" WIDTH="33%">
<TBODY>
<TR>
<TD ALIGN="LEFT"><A HREF="chapter1.html">Chapter 1</A></TD>
<TD ALIGN="CENTER"><A HREF="contents.html">Contents</A></TD>
<TD ALIGN="RIGHT"><A HREF="chapter3.html">Chapter 3</A></TD>
</TR>
</TBODY>
</TABLE>
<HR></DIV>
<H1 ID="S2"><SPAN CLASS="chapnum">2</SPAN> Screen Control Command</H1>
<P>Screen control commands let you set parameters and attributes for the complete
screen, or perform actions affecting the complete screen. There are 10
options to the screen control command.</P>
<UL>
<LI>Display addressing</LI>
<LI>Scroll</LI>
<LI>Hard copy control</LI>
<LI>Output mapping</LI>
<LI>Background intensity</LI>
<LI>Time delay</LI>
<LI>Screen erase</LI>
<LI>Temporary write control</LI>
<LI>Graphics cursor control</LI>
<LI>Display graphics page</LI>
</UL>
<H2 ID="S2.1">Display Addressing</H2>
<P>The VT300 uses an [X,Y] screen coordinate system, described in <A HREF="chapter1.html">Chapter 1</A>.
This system has default values of [0,0] for the upper-left corner and [799,479]
for the lower-right corner. You should use these default values for most ReGIS
applications.</P>
<P>You use the following format for a screen command using the display addressing option.</P>
<BLOCKQUOTE>
<P>S(A[X1,Y1][X2,Y2])</P>
</BLOCKQUOTE>
<P>where</P>
<BLOCKQUOTE>
<P><B>S</B> indicates a screen command.</P>
<P><B>A</B> indicates the display addressing option.</P>
<P><B>[X1,Y1]</B> is the coordinate for the upper-left corner.</P>
<P><B>[X2,Y2]</B> is the coordinate for the lower-right corner.</P>
</BLOCKQUOTE>
<P>You must include values for the upper-left and lower-right positions, or ReGIS
ignores the command. When you change the default values, the terminal must
perform an additional scaling step for each coordinate. This extra step can slow
down performance.</P>
<P CLASS="note">NOTE: Pixel vector (PV) values depend on the display-addressing coordinates
and the PV multiplier. However, PV directions are independent of addressing
orientation. For example, 0 is always to the right.</P>
<H3 ID="S2.1.1">Display Address Values</H3>
<P>You can write ReGIS code for devices that have a different address range than
the VT300. The display addressing option lets you run ReGIS code written for
another device on the VT300, without converting all the coordinates. The terminal
takes care of scaling the coordinate system.</P>
<P CLASS="note">NOTE: Applications should use the display addressing option to make ReGIS
images portable between devices that use different address ranges. The address
range you define should match the default address range of the device
you are coding for. This operation ensures that the device interprets all ReGIS
commands consistently.</P>
<P>You can use exponential numbers as well as decimal numbers in your address
definition. In any case, make sure the aspect ratio of the screen area you define
is as close as possible to the default ratio of [0,0] by [799,479]. If not, the terminal
clips the screen area to a display area that is close to the aspect ratio
you specified.</P>
<P>The VT300 maintains the correct aspect ratio when displaying a picture created
for another device. Squares are always square, and angles are always correct.
For example, suppose you want to display a picture created for a VT125 terminal.
This picture uses the display addressing for a VT125. The VT300 maps the
default screen addressing of the VT125 into the leftmost 768 pixel columns of
the VT300.</P>
<H3 ID="S2.1.2">Address Range</H3>
<P><A HREF="#F2-1">Figure 2-1</A> shows the effective address range when you use the default values
of [0,0] and [799,479].</P>
<TABLE ID="F2-1" CLASS="figure" WIDTH="100%">
<CAPTION>Figure 2-1 Effective Address Range</CAPTION>
<COL ALIGN="CENTER">
<TBODY>
<TR>
<TD><IMG SRC="ma-0658-83.png" ALT=""></TD>
</TR>
</TBODY>
</TABLE>
<P>You can use negative addresses, but you cannot address them directly. There is
no valid way to specify an absolute negative address. However, you can specify
a relative value that produces a negative address. The negative address should
not exceed the address range. If it does exceed the address range, then the
terminal wraps the line.</P>
<P>If you need to invert the current addressing range, you can use any values for
the left, right, top, and bottom margins. If the right margin value is less than
the left margin value, then the X-coordinate increases to the left instead of to
the right (as it would in the default coordinate system). If the bottom margin
value is less than the top margin value, then the Y-coordinate increases upward
instead of downward.</P>
<H2 ID="S2.2">Scroll Argument</H2>
<P>This argument lets you offset screen data within the display medium (the bitmap),
without changing the coordinate system. Only the data is offset, not the
coordinate system. The image moves relative to the screen origin.</P>
<P>There are two forms of the scroll argument. One form uses coordinate values
for movement, the other form uses pixel vector (PV) values. The position you
specify becomes the new upper-left corner of the screen, whether you use coordinates
or PV values.</P>
<P>Any data scrolled out of the boundaries of the screen is lost. You cannot recover
that data by reversing the scrolling.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<THEAD>
<TR>
<TH CLASS="first">Using Coordinate Values</TH>
<TH>Using PV Values</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD CLASS="first">S[X,Y]</TD>
<TD>S&lt;PV value&gt;</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>[X,Y]</B> is a coordinate value defining movement. You can use relative coordinates
such as [+X,+Y], [-X,-Y], [+X], [-X], [,+Y], or [,-Y]; absolute coordinates
such as [X], [,Y], or [X,Y]; or absolute/relative coordinates such as
[+X,Y], [-X,Y], [X,+Y], or [X,-Y].</P>
<P><B>&lt;PV values&gt;</B> are one or more pixel vector (PV) values defining movement,
at the currently selected PV multiplication value.</P></DIV>
<H3 ID="S2.2.1">PV Multiplication</H3>
<P>When you use PV values, the scroll argument uses the currently selected PV
multiplication factor. You can select a different factor by using a temporary
write control option. The terminal only uses this temporary value until you use
a new command key letter or another temporary write control option.</P>
<P>You use the following format to select a temporary PV multiplication factor.</P>
<DIV CLASS="example"><P>S(W(M&lt;multiplication factor&gt;))&lt;PV value&gt;</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>W</B> identifies a temporary write control option.</P>
<P><B>M</B> identifies a PV multiplication suboption.</P>
<P><B>&lt;multiplication factor&gt;</B> is a numeric value.</P>
<P><B>&lt;PV values&gt;</B> are one or more PV values that will use the multiplication
factor for movement.</P></DIV>
<H2 ID="S2.3">Hard Copy Control &#8211; H</H2>
<P>This option lets you print a hard copy of the screen image. You can select what
part of the screen to print and what starting offset to use for the printer.</P>
<P>There are three ways to select what part of a screen to print: with no position,
one position, or two positions.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<THEAD>
<TR>
<TH CLASS="first">No Position</TH>
<TH>One Position</TH>
<TH>Two Positions</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD CLASS="first">S(H)</TD>
<TD>S(H[X,Y])</TD>
<TD>S(H[X1,Y1][X2,Y2])</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>H</B> identifies a hard copy control option. If you do not specify a coordinate
position with this option, you select the complete screen for printing.</P>
<P><B>[X,Y]</B> is one corner of the area to print. The terminal uses that position
and the current cursor position to define the opposite corners of a rectangular
area for printing.</P>
<P><B>[X1,Y1][X2,Y2]</B> are two opposing corners of the area to print.</P></DIV>
<P><A HREF="#F2-2">Figure 2-2</A> shows an example of the two-position option, and <A HREF="#F2-3">Figure 2-3</A> shows
an example of the one-position option.</P>
<TABLE ID="F2-2" CLASS="figure" WIDTH="100%">
<CAPTION>Figure 2-2 Hard Copy Control Example (Two Positions)</CAPTION>
<COL ALIGN="CENTER">
<COL WIDTH="460" ALIGN="RIGHT">
<TBODY>
<TR>
<TD><TABLE CLASS="command-example" FRAME="BORDER" RULES="GROUPS" CELLSPACING="0" CELLPADDING="8">
<TBODY>
<TR>
<TD ALIGN="CENTER">COMMANDS</TD>
</TR>
</TBODY>
<TBODY>
<TR VALIGN="TOP">
<TD>S(H[150,150][400,200])</TD>
</TR>
</TBODY>
</TABLE></TD>
<TD><IMG SRC="ma-0659-83r.png" ALT=""></TD>
</TR>
<TR>
<TD></TD>
<TD ALIGN="LEFT"><SMALL>NOTE:<BR>Dots and lines would not appear in actual display.<BR>&nbsp;</SMALL></TD>
</TR>
</TBODY>
</TABLE>
<TABLE ID="F2-3" CLASS="figure" WIDTH="100%">
<CAPTION>Figure 2-3 Hard Copy Control Example (One Position)</CAPTION>
<COL ALIGN="CENTER">
<COL WIDTH="460" ALIGN="RIGHT">
<TBODY>
<TR>
<TD><TABLE CLASS="command-example" FRAME="BORDER" RULES="GROUPS" CELLSPACING="0" CELLPADDING="8">
<TBODY>
<TR>
<TD ALIGN="CENTER">COMMANDS</TD>
</TR>
</TBODY>
<TBODY>
<TR VALIGN="TOP">
<TD>S(H[400,200])</TD>
</TR>
</TBODY>
</TABLE></TD>
<TD><IMG SRC="ma-0660-83r.png" ALT=""></TD>
</TR>
<TR>
<TD></TD>
<TD ALIGN="LEFT"><SMALL>NOTE:<BR>Dots and lines would not appear in actual display.<BR>&nbsp;</SMALL></TD>
</TR>
</TBODY>
</TABLE>
<P>You can use absolute or relative values for coordinates. If you use relative values,
then the positions are relative to the cursor position, not to any other
position specified.</P>
<P>You can send the selected area of the screen to the printer or to the host. This
action is under the control of printing control functions. See <A HREF="chapter16.html">Chapter 16</A> for the
graphics printing functions. You can print a compressed or expanded format by
using the <B CLASS="feature">Graphics Print</B> feature in the Graphics Set-Up screen.</P>
<H3 ID="S2.3.1">Printing Offset</H3>
<P>You can specify a printing offset with the P suboption to the H option. The P
suboption defines the starting offset for a graphic image. This is a relative offset
between the current position of the printhead and the position where the
upper-left corner of the graphic image will print.</P>
<P>You can only use the P suboption to change the default value. The new value remains
in effect until you use another P suboption. You use the following format
for the printing offset suboption.</P>
<DIV CLASS="example"><P>S(H(P[X,Y]))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>H</B> identifies a hard copy control option.</P>
<P><B>P</B> identifies a printing offset suboption.</P>
<P><B>[X,Y]</B> is a relative position offset. The default value is [50,0].</P></DIV>
<P>You can also define the print area and specify the printing offset in the same
command, as follows.</P>
<DIV CLASS="example"><P>S(H(P[X,Y])[X1,Y1][X2,Y2])</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>[X1,Y1][X2,Y2]</B> are two opposing corners of the area to print.</P></DIV>
<P>The P suboption prints the complete screen at the defined offset.</P>
<P>The printing offset is independent of screen addressing. The offset occurs at
the printer. The actual distance of the offset depends on the size of the pixels
used by the printer.</P>
<H2 ID="S2.4">Output Mapping Control &#8211; M</H2>
<P>This option lets you change the current output map for the terminal. Output
mapping lets you easily change the color or shading of an image. The format of
this command depends on whether you are using a monochrome or color display.</P>
<P>The VT330 and VT340 use different forms of output mapping. The VT340 uses
a color monitor and a 4-plane bitmap. The VT330 uses a monochrome monitor
and a 2-plane bitmap. The next two sections describe the differences between
the VT330 and VT340. Then the following sections describe the command formats
for monochrome and color displays.</P>
<H3 ID="S2.4.1">VT330 Monochrome Map</H3>
<P>The VT330 has four output map locations in RAM. Each location stores a monochrome
shade value. The output mapping option lets you change those values.
Each location has a default value.</P>
<P><A HREF="#T2-1">Table 2-1</A> shows the default monochrome map for the VT330. The table lists
the default HLS (hue, lightness, and saturation) and RGB (red, green, and blue)
values for each shade. The HLS and RGB color coordinate systems are described
later in this chapter.</P>
<TABLE ID="T2-1" CLASS="majortable">
<CAPTION>Table 2-1 VT330 Default Monochrome Map</CAPTION>
<THEAD>
<TR VALIGN="BOTTOM">
<TH ROWSPAN="2">Map Location</TH>
<TH ROWSPAN="2">Default Shade</TH>
<TH ID="TS0211" COLSPAN="3">HLS Values</TH>
<TH ID="TS0212" COLSPAN="3">RGB Values</TH>
</TR>
<TR>
<TH>H</TH>
<TH>L</TH>
<TH>S</TH>
<TH>R</TH>
<TH>G</TH>
<TH>B</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>0</TD>
<TD>Black</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>1</TD>
<TD>Dark gray</TD>
<TD>120</TD>
<TD>50</TD>
<TD>100</TD>
<TD>100</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>2</TD>
<TD>Light gray</TD>
<TD>240</TD>
<TD>50</TD>
<TD>100</TD>
<TD>0</TD>
<TD>100</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>3</TD>
<TD>White</TD>
<TD>180</TD>
<TD>100</TD>
<TD>100</TD>
<TD>100</TD>
<TD>100</TD>
<TD>0</TD>
</TR>
</TBODY>
</TABLE>
<P>The 2-plane bitmap for the VT330 provides a 2-bit code for each pixel. The
code selects one of the four output map locations. This means each pixel has
four possible intensity values. You can change the intensity value of the pixel
by changing its 2-bit code.</P>
<P>You can draw an image, then change its appearance by changing the associated
output map location. You do not have to rewrite each pixel in order to address
a different output map position. That is, you do not have to redraw an image
to change its color.</P>
<P><A HREF="#F2-4">Figure 2-4</A> provides an example of the output mapping process. The top half of
the figure shows default values. In the bottom half, the value of 0 has been
changed to light gray, and the value of 2 to dark gray.</P>
<TABLE ID="F2-4" CLASS="figure" WIDTH="100%">
<CAPTION>Figure 2-4 Output Mapping Example (Monochrome)</CAPTION>
<COL ALIGN="CENTER">
<TBODY>
<TR>
<TD><IMG SRC="ma-0661-83r.png" ALT=""></TD>
</TR>
</TBODY>
</TABLE>
<H3 ID="S2.4.2">VT340 Monochrome and Color Maps</H3>
<P>The VT340 has 16 output map locations in RAM. Each location stores a monochrome
shade value and a color value. The output mapping option lets you
change the values stored in these locations. Each location has default monochrome
and color values.</P>
<P><STRONG>When an application selects the monochrome map:</STRONG> the terminal sets the 16 entries
of the color map to the default monochrome gray level. Therefore, the
original colors are lost when changing from the color map to the monochrome map.</P>
<P>If you change the color value (green, red, blue) using the Color Set-Up
screen or a ReGIS command, the VT340 sets the gray scale by using the formula
<STRONG>(2G&nbsp;+&nbsp;R)/3</STRONG>.</P>
<P><STRONG>When an application selects the color map:</STRONG> the terminal sets the 16 entries of
the color map to the default (color) color map.</P>
<P><A HREF="#T2-2">Table 2-2</A> shows the default monochrome shade map for the VT340. <A HREF="#T2-3">Table 2-3</A>
shows the default color map for the VT340. Each table lists the default HLS
(hue, lightness, and saturation) and RGB (red, green, and blue) values for each
shade/color. The HLS and RGB color coordinate systems are described later in
this chapter.</P>
<P>The 4-plane bitmap for the VT340 provides a 4-bit code for each pixel. This
means each pixel has 16 possible values. Each value corresponds to a specific
output map location. You can change the intensity value or color of a pixel by
changing its 4-bit code. The next two sections describe how to change monochrome
and color values.</P>
<TABLE ID="T2-2" CLASS="majortable">
<CAPTION>Table 2-2 VT340 Default Monochrome Map</CAPTION>
<THEAD>
<TR VALIGN="BOTTOM">
<TH ROWSPAN="2">Map Location</TH>
<TH ROWSPAN="2">Default Shade</TH>
<TH ID="TS0221" COLSPAN="3">HLS Values</TH>
<TH ID="TS0222" COLSPAN="3">RGB Values</TH>
</TR>
<TR>
<TH>H</TH>
<TH>L</TH>
<TH>S</TH>
<TH>R</TH>
<TH>G</TH>
<TH>B</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>0</TD>
<TD>Black</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>1</TD>
<TD>Gray-2</TD>
<TD>0</TD>
<TD>13</TD>
<TD>0</TD>
<TD>13</TD>
<TD>13</TD>
<TD>13</TD>
</TR>
<TR VALIGN="TOP">
<TD>2</TD>
<TD>Gray-4</TD>
<TD>0</TD>
<TD>26</TD>
<TD>0</TD>
<TD>26</TD>
<TD>26</TD>
<TD>26</TD>
</TR>
<TR VALIGN="TOP">
<TD>3</TD>
<TD>Gray-6</TD>
<TD>0</TD>
<TD>40</TD>
<TD>0</TD>
<TD>40</TD>
<TD>40</TD>
<TD>40</TD>
</TR>
<TR VALIGN="TOP">
<TD>4</TD>
<TD>Gray-1</TD>
<TD>0</TD>
<TD>6</TD>
<TD>0</TD>
<TD>6</TD>
<TD>6</TD>
<TD>6</TD>
</TR>
<TR VALIGN="TOP">
<TD>5</TD>
<TD>Gray-3</TD>
<TD>0</TD>
<TD>20</TD>
<TD>0</TD>
<TD>20</TD>
<TD>20</TD>
<TD>20</TD>
</TR>
<TR VALIGN="TOP">
<TD>6</TD>
<TD>Gray-5</TD>
<TD>0</TD>
<TD>33</TD>
<TD>0</TD>
<TD>33</TD>
<TD>33</TD>
<TD>33</TD>
</TR>
<TR VALIGN="TOP">
<TD>7</TD>
<TD>White 7</TD>
<TD>0</TD>
<TD>46</TD>
<TD>0</TD>
<TD>46</TD>
<TD>46</TD>
<TD>46</TD>
</TR>
<TR VALIGN="TOP">
<TD>8</TD>
<TD>Black 0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>9</TD>
<TD>Gray-2</TD>
<TD>0</TD>
<TD>13</TD>
<TD>0</TD>
<TD>13</TD>
<TD>13</TD>
<TD>13</TD>
</TR>
<TR VALIGN="TOP">
<TD>10</TD>
<TD>Gray-4</TD>
<TD>0</TD>
<TD>26</TD>
<TD>0</TD>
<TD>26</TD>
<TD>26</TD>
<TD>26</TD>
</TR>
<TR VALIGN="TOP">
<TD>11</TD>
<TD>Gray-6</TD>
<TD>0</TD>
<TD>40</TD>
<TD>0</TD>
<TD>40</TD>
<TD>40</TD>
<TD>40</TD>
</TR>
<TR VALIGN="TOP">
<TD>12</TD>
<TD>Gray-1</TD>
<TD>0</TD>
<TD>6</TD>
<TD>0</TD>
<TD>6</TD>
<TD>6</TD>
<TD>6</TD>
</TR>
<TR VALIGN="TOP">
<TD>13</TD>
<TD>Gray-3</TD>
<TD>0</TD>
<TD>20</TD>
<TD>0</TD>
<TD>20</TD>
<TD>20</TD>
<TD>20</TD>
</TR>
<TR VALIGN="TOP">
<TD>14</TD>
<TD>Gray-5</TD>
<TD>0</TD>
<TD>33</TD>
<TD>0</TD>
<TD>33</TD>
<TD>33</TD>
<TD>33</TD>
</TR>
<TR VALIGN="TOP">
<TD>15</TD>
<TD>White 7</TD>
<TD>0</TD>
<TD>46</TD>
<TD>0</TD>
<TD>46</TD>
<TD>46</TD>
<TD>46</TD>
</TR>
</TBODY>
</TABLE>
<TABLE ID="T2-3" CLASS="majortable">
<CAPTION>Table 2-3 VT340 Default Color Map</CAPTION>
<THEAD>
<TR VALIGN="BOTTOM">
<TH ROWSPAN="2">Map Location</TH>
<TH ROWSPAN="2">Default Color</TH>
<TH ID="TS0231" COLSPAN="3">HLS Values</TH>
<TH ID="TS0232" COLSPAN="3">RGB Values</TH>
</TR>
<TR>
<TH>H</TH>
<TH>L</TH>
<TH>S</TH>
<TH>R</TH>
<TH>G</TH>
<TH>B</TH>
</TR>
</THEAD>
<TFOOT>
<TR>
<TD COLSPAN="8">* These colors are less saturated than colors 1 through 6.</TD>
</TR>
</TFOOT>
<TBODY>
<TR VALIGN="TOP">
<TD>0</TD>
<TD>Black</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
<TD>0</TD>
</TR>
<TR VALIGN="TOP">
<TD>1</TD>
<TD>Blue</TD>
<TD>0</TD>
<TD>50</TD>
<TD>60</TD>
<TD>20</TD>
<TD>20</TD>
<TD>80</TD>
</TR>
<TR VALIGN="TOP">
<TD>2</TD>
<TD>Red</TD>
<TD>120</TD>
<TD>46</TD>
<TD>72</TD>
<TD>80</TD>
<TD>13</TD>
<TD>13</TD>
</TR>
<TR VALIGN="TOP">
<TD>3</TD>
<TD>Green</TD>
<TD>240</TD>
<TD>50</TD>
<TD>60</TD>
<TD>20</TD>
<TD>80</TD>
<TD>20</TD>
</TR>
<TR VALIGN="TOP">
<TD>4</TD>
<TD>Magenta</TD>
<TD>60</TD>
<TD>50</TD>
<TD>60</TD>
<TD>80</TD>
<TD>20</TD>
<TD>80</TD>
</TR>
<TR VALIGN="TOP">
<TD>5</TD>
<TD>Cyan</TD>
<TD>300</TD>
<TD>50</TD>
<TD>60</TD>
<TD>20</TD>
<TD>80</TD>
<TD>80</TD>
</TR>
<TR VALIGN="TOP">
<TD>6</TD>
<TD>Yellow</TD>
<TD>180</TD>
<TD>50</TD>
<TD>60</TD>
<TD>80</TD>
<TD>80</TD>
<TD>20</TD>
</TR>
<TR VALIGN="TOP">
<TD>7</TD>
<TD>Gray 50%</TD>
<TD>0</TD>
<TD>53</TD>
<TD>0</TD>
<TD>53</TD>
<TD>53</TD>
<TD>53</TD>
</TR>
<TR VALIGN="TOP">
<TD>8</TD>
<TD>Gray 25%</TD>
<TD>0</TD>
<TD>26</TD>
<TD>0</TD>
<TD>26</TD>
<TD>26</TD>
<TD>26</TD>
</TR>
<TR VALIGN="TOP">
<TD>9</TD>
<TD>Blue*</TD>
<TD>0</TD>
<TD>46</TD>
<TD>29</TD>
<TD>33</TD>
<TD>33</TD>
<TD>60</TD>
</TR>
<TR VALIGN="TOP">
<TD>10</TD>
<TD>Red*</TD>
<TD>120</TD>
<TD>43</TD>
<TD>39</TD>
<TD>60</TD>
<TD>26</TD>
<TD>26</TD>
</TR>
<TR VALIGN="TOP">
<TD>11</TD>
<TD>Green*</TD>
<TD>240</TD>
<TD>46</TD>
<TD>29</TD>
<TD>33</TD>
<TD>60</TD>
<TD>33</TD>
</TR>
<TR VALIGN="TOP">
<TD>12</TD>
<TD>Magenta*</TD>
<TD>60</TD>
<TD>46</TD>
<TD>29</TD>
<TD>60</TD>
<TD>33</TD>
<TD>60</TD>
</TR>
<TR VALIGN="TOP">
<TD>13</TD>
<TD>Cyan*</TD>
<TD>300</TD>
<TD>46</TD>
<TD>29</TD>
<TD>33</TD>
<TD>60</TD>
<TD>60</TD>
</TR>
<TR VALIGN="TOP">
<TD>14</TD>
<TD>Yellow*</TD>
<TD>180</TD>
<TD>46</TD>
<TD>29</TD>
<TD>60</TD>
<TD>60</TD>
<TD>33</TD>
</TR>
<TR VALIGN="TOP">
<TD>15</TD>
<TD>Gray 75%</TD>
<TD>0</TD>
<TD>80</TD>
<TD>0</TD>
<TD>80</TD>
<TD>80</TD>
<TD>80</TD>
</TR>
</TBODY>
</TABLE>
<H3 ID="S2.4.3">Changing Monochrome Values</H3>
<P>Use the following steps to change a monochrome value in the VT330 or VT340.</P>
<OL>
<LI><P>Select the output map location.</P>
<P>For the VT330: 0 through 3</P>
<P>For the VT340: 0 through 15</P></LI>
<LI><P>Select the new lightness value. You can use any L value in the following
ranges to select the shade listed.</P>
<TABLE>
<THEAD>
<TR VALIGN="BOTTOM">
<TH COLSPAN="2">VT330 Shades</TH>
<TH COLSPAN="2">VT340 Shades</TH>
</TR>
<TR VALIGN="BOTTOM">
<TH>Lightness Range</TH>
<TH>Shade</TH>
<TH>Lightness Range</TH>
<TH>Shade</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>L0 to L24</TD>
<TD>black</TD>
<TD>L0 to L3</TD>
<TD>black</TD>
</TR>
<TR VALIGN="TOP">
<TD>L25 to L49</TD>
<TD>dark gray</TD>
<TD>L4 to L9</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD>L50 to L74</TD>
<TD>light gray</TD>
<TD>L10 to L16</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD>L75 to L100</TD>
<TD>white</TD>
<TD>L17 to L23</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L24 to L29</TD>
<TD>V</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L30 to L36</TD>
<TD>dark gray</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L37 to L43</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L44 to L49</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L50 to L56</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L57 to L63</TD>
<TD>V</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L64 to L69</TD>
<TD>light gray</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L70 to L76</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L77 to L83</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L84 to L89</TD>
<TD>|</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L90 to L96</TD>
<TD>V</TD>
</TR>
<TR VALIGN="TOP">
<TD></TD>
<TD></TD>
<TD>L96 to L100</TD>
<TD>white</TD>
</TR>
</TBODY>
</TABLE></LI>
</OL>
<P>The following example changes the monochrome values in three output map
locations.</P>
<DIV CLASS="example"><P>S(M1(L25)2(L99)3(L50))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>M</B> identifies an output mapping suboption.</P>
<P><B>1</B> selects output mapping location 1.</P>
<P><B>(L25)</B> specifies a lightness value of dim gray.</P>
<P><B>2</B> selects output mapping location 2.</P>
<P><B>(L99)</B> specifies a lightness value of white.</P>
<P><B>3</B> selects output mapping location 3.</P>
<P><B>(L50)</B> specifies a lightness value of light gray.</P></DIV>
<P CLASS="note">PROGRAMMING TIP: The VT340 uses the lightness value for both the monochrome
and color values of output map locations. To change the monochrome
value without changing the color value, use both the monochrome and color options.</P>
<P CLASS="note">You must specify the monochrome value first, followed by the color value. You
can specify both values in a single command.</P>
<H3 ID="S2.4.4">Changing Color Values (VT340 Only)</H3>
<P>You can use two different color value systems to change the color values for
output map locations.</P>
<UL>
<LI>RGB (red, green, and blue)</LI>
<LI>HLS (hue, lightness, and saturation)</LI>
</UL>
<P>Use the following steps to change the color value of an output map location in
the VT340. Tables <A HREF="#T2-2">2-2</A> and <A HREF="#T2-3">2-3</A> list the default HLS and RGB values.</P>
<OL>
<LI><P>Specify the output map location: 0 through 15.</P></LI>
<LI><P>Define the new color value with one of the following.</P>
<OL>
<LI>a single letter of the RGB system, or</LI>
<LI>the hue, lightness, and saturation values of the HLS system</LI>
</OL>
<P>You cannot mix HLS and RGB values in a single command. The
following sections explain the values used with each system.</P></LI>
</OL>
<H4 ID="S2.4.4.1">RGB System</H4>
<P>The RGB (red, green, and blue) system uses single letters to
specify eight different colors and/or shades.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<TBODY>
<TR>
<TD CLASS="first">D</TD>
<TD>dark (black)</TD>
</TR>
<TR>
<TD CLASS="first">R</TD>
<TD>red</TD>
</TR>
<TR>
<TD CLASS="first">G</TD>
<TD>green</TD>
</TR>
<TR>
<TD CLASS="first">B</TD>
<TD>blue</TD>
</TR>
<TR>
<TD CLASS="first">C</TD>
<TD>cyan (from blue and green)</TD>
</TR>
<TR>
<TD CLASS="first">Y</TD>
<TD>yellow (from red and green)</TD>
</TR>
<TR>
<TD CLASS="first">M</TD>
<TD>magenta (from red and blue)</TD>
</TR>
<TR>
<TD CLASS="first">W</TD>
<TD>white</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>Cyan, yellow, and magenta are secondary colors made from an equal mixture of
two primary colors.</P>
<P>The following example shows how to specify RGB colors.</P>
<DIV CLASS="example"><P>S(M0(AR)2(AG))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>M</B> specifies an output mapping location.</P>
<P><B>0</B> selects output map location 0.</P>
<P><B>A</B> indicates the next value only affects the color value of the output map location.</P>
<P><B>R</B> selects the RGB value for red.</P>
<P><B>2</B> selects output map location 2.</P>
<P><B>G</B> selects the RGB value for green.</P></DIV>
<DIV CLASS="note"><P>PROGRAMMING TIP: Normally, the A suboption to the M option of the
screen control command S(M(A...)) specifies that only the color value of the
output map is to change. The monochrome value remains unchanged.</P>
<P><EM>On the VT330</EM>, there is no color mode. If the VT330 receives an output mapping
command with the A suboption, the VT330 ignores the command. In this
respect, the VT330 works like the VT240.</P>
<P><EM>On the VT340</EM>, there is one set of output map values for both color and monochrome
modes. Therefore, the A suboption has no effect on the VT340. If you
change an output map value and specify the A option, that output map value
is changed for both color and monochrome modes.</P></DIV>
<H4 ID="S2.4.4.2">HLS System</H4>
<P>The HLS system provides a much larger color selection than
the RGB system. The HLS system uses different values of hue (H), lightness
(L), and saturation (S), to provide 4096 possible colors and shades.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<TBODY>
<TR>
<TD CLASS="first">H for hue angle</TD>
<TD>0 to 360 degrees</TD>
</TR>
<TR>
<TD CLASS="first">L for lightness</TD>
<TD>0 to 100 percent</TD>
</TR>
<TR>
<TD CLASS="first">S for color saturation</TD>
<TD>0 to 100 percent</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>The hue angles for the three primary colors are as follows.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<COL>
<COL ALIGN="RIGHT">
<TBODY>
<TR>
<TD CLASS="first">Blue:</TD>
<TD>0 degrees</TD>
</TR>
<TR>
<TD CLASS="first">Red:</TD>
<TD>120 degrees</TD>
</TR>
<TR>
<TD CLASS="first">Green:</TD>
<TD>240 degrees</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P><A HREF="appendixa.html#TA-1">Table A-1</A> in <A HREF="appendixa.html">Appendix A</A> lists all the HLS colors and shades that correspond to
the VT241 terminal. You can use these different combinations of hue, lightness,
and saturation to select specific colors for your VT340 graphics.</P>
<P>The following example shows how to specify HLS colors.</P>
<DIV CLASS="example"><P>S(M1(AH60L80S60)3(AH150L50S60))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>M</B> identifes an output mapping location.</P>
<P><B>1</B> selects output map location 1.</P>
<P><B>A</B> indicates the next value only affects the color value of the output map location.</P>
<P><B>H60L80S60</B> selects the HLS value for plum.</P>
<P><B>3</B> selects output map location 3.</P>
<P><B>H150L50S60</B> selects the HLS value for gold.</P></DIV>
<H2 ID="S2.5">Background Intensity Control &#8211; I</H2>
<P>This option lets you select the shade or color of the display background. You
can use one of two methods.</P>
<UL>
<LI><P>Provide the output map location number.</P>
<TABLE CLASS="padded">
<TBODY>
<TR>
<TD CLASS="first">VT330</TD>
<TD>0 through 3</TD>
</TR>
<TR>
<TD CLASS="first">VT340</TD>
<TD>0 through 15</TD>
</TR>
</TBODY>
</TABLE></LI>
<LI><P>Provide an RGB or HLS value (VT340 only).</P></LI>
</UL>
<P>The first method provides the greatest degree control within a plane. You
simply select the number corresponding to the color you want for a
background.</P>
<P>You should use the second method when you need to transfer an image to
other ReGIS devices. The terminal selects the background color by using the
output map location with the closest value to the HLS or RGB value in your
command.</P>
<P>However, the VT340 has a limited ability to compare values. Make sure the
RGB or HLS value you select already exists in an output map location. If you
use a value much different from the current output map values, the result is
unpredictable. The value you use does not change the values in the output map.</P>
<P>The following examples show how to specify the background intensity using
screen options.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<THEAD>
<TR>
<TH CLASS="first">Output Map</TH>
<TH>RGB Specifier</TH>
<TH>HLS Specifier</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD CLASS="first">S(I0)</TD>
<TD>S(I(R))</TD>
<TD>S(I(H180L50S100))</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>I</B> identifies a background intensity option.</P>
<P><B>0</B> selects output map location 0 for background color.</P>
<P><B>(R)</B> is an RGB value selecting the output map location that has the color closest to red.</P>
<P><B>(H180L50S100)</B> is an HLS value selecting the output map location that has the color closest
to yellow.</P></DIV>
<H2 ID="S2.6">Time Delay &#8211; T</H2>
<P>This option lets you insert a time delay before a ReGIS instruction. You specify
the delay time as a number of ticks, where 60 ticks equal 1 second. The maximum
time delay you can use is 32,767 ticks (about 9.1 minutes).</P>
<P>The following example shows how to specify a time delay.</P>
<DIV CLASS="example"><P>S(T60)</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>T</B> identifies a time delay option.</P>
<P><B>60</B> selects the number of ticks to use. (60 ticks = 1 second)</P></DIV>
<H2 ID="S2.7">Screen Erase &#8211; E</H2>
<P>This option lets you erase the screen by setting the complete screen to the
display background color. The screen erase option does not change the position
of the text or graphics cursor, or the values stored in the output map.</P>
<P>You use the following format for the screen erase option.</P>
<DIV CLASS="example"><P>S(E)</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>E</B> identifies a screen erase option.</P></DIV>
<P>The screen erase command affects ReGIS as follows.</P>
<UL>
<LI><P>Does not change the current background color or shade.</P></LI>
<LI><P>Does not change the cursor position.</P></LI>
<LI><P>Turns off any shading specified by the write control command.</P></LI>
<LI><P>Stops any curve interpolation.</P></LI>
<LI><P>Clears all position stacks. (See <A HREF="chapter4.html">Chapter 4</A>.)</P></LI>
</UL>
<H2 ID="S2.8">Temporary Write Control &#8211; W</H2>
<P>This option lets you set any writing control (<A HREF="chapter3.html">Chapter 3</A>). However, the PV multiplier
suboption is the only useful write control for screen control commands.
You use the PV multiplier suboption with the screen scroll argument, when
using a PV value to define an amount of scrolling.</P>
<P>The following example shows a temporary write control option used with the
PV multiplier suboption.</P>
<DIV CLASS="example"><P>S(W(M15))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>W</B> identifies a screen write option.</P>
<P><B>M</B> identifies a PV multiplier suboption.</P>
<P><B>15</B> selects a multiplication factor of 15.</P></DIV>
<H2 ID="S2.9">Graphics Cursor Control &#8211; C</H2>
<P>This option lets you select whether or not to display the graphics output cursor.
You can also select the style of graphics output cursor (with the H suboption)
and graphics input cursor (with the I suboption).</P>
<P>The graphics cursor is a composite character in two shades or colors. The
VT330 uses output map location 0 for the foreground, and location 1 for the
background. The VT340 uses location 0 for the foreground, and location 15 for
the background.</P>
<P>The "<A HREF="chapter1.html#S1.7">Graphics Cursors</A>" section in <A HREF="chapter1.html">Chapter 1</A> describes the styles of graphics
cursors available. You use the following command to turn the cursor on or off.</P>
<DIV CLASS="example"><P>S(C&lt;0 or 1&gt;)</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>C</B> identifies a cursor control option.</P>
<P><B>0</B> turns the output cursor off.</P>
<P><B>1</B> turns the output cursor on.</P></DIV>
<H3 ID="S2.9.1">Graphics Output Cursor &#8211; H</H3>
<P>The H suboption lets you select the style of graphics output cursor. You select
cursor style by number. The following table lists the output cursor styles and
their numbers.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<THEAD>
<TR>
<TH CLASS="first">Number</TH>
<TH>Cursor Style</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD CLASS="first">Omitted</TD>
<TD>Diamond</TD>
</TR>
<TR>
<TD CLASS="first">0 or 1</TD>
<TD>Diamond (default)</TD>
</TR>
<TR>
<TD CLASS="first">2</TD>
<TD>Crosshair</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>The following example shows how to use the graphics cursor option with the H
suboption.</P>
<DIV CLASS="example"><P>S(C(H1))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>C</B> identifies a cursor control option.</P>
<P><B>H</B> identifies the output cursor suboption.</P>
<P><B>1</B> selects the diamond cursor for the output cursor.</P></DIV>
<H3 ID="S2.9.2">Graphics Input Cursor &#8211; I</H3>
<P>The I suboption lets you select the style of graphics input cursor. You can select
a standard cursor style or define your own style.</P>
<H4 ID="S2.9.3.1">Standard Styles</H4>
<P>You can select a standard cursor style by number. This is
the same method used with the H suboption. The following table lists the input
cursor styles and their numbers.</P>
<DIV CLASS="example"><TABLE CLASS="padded">
<THEAD>
<TR>
<TH CLASS="first">Number</TH>
<TH>Cursor Style</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD CLASS="first">Omitted</TD>
<TD>Crosshair</TD>
</TR>
<TR>
<TD CLASS="first">0</TD>
<TD>Crosshair (default)</TD>
</TR>
<TR>
<TD CLASS="first">1</TD>
<TD>Diamond</TD>
</TR>
<TR>
<TD CLASS="first">2</TD>
<TD>Crosshair</TD>
</TR>
<TR>
<TD CLASS="first">3</TD>
<TD>Rubber band line</TD>
</TR>
<TR>
<TD CLASS="first">4</TD>
<TD>Rubber band rectangle</TD>
</TR>
</TBODY>
</TABLE></DIV>
<H4 ID="S2.9.3.2">User-Defined Style</H4>
<P>You can define your own input cursor by using a character
mask. You specify two characters to use for the cursor. One character is
displayed in the foreground color, the other in the background color. ReGIS
combines these two characters into a composite character, or character mask.</P>
<P>The cursor is a composite character in two colors or shades. The VT330 uses
monochrome map entry 2 for the foreground and entry 1 for the background.
The VT340 uses color map entry 14 for the foreground and entry 1 for the background.</P>
<P>The cursor size is limited to 16 &times; 24 pixels. If you define a larger cursor, the
terminal clips the cursor to fit into the 16 &times; 24 cell.</P>
<P>You can use characters from the terminal's built-in character sets to build a
graphics cursor. You can also design your own cursor characters and load them
into the terminal from the host system. The characters used to build the cursor
must be in the currently loaded character set. See Chapters <A HREF="chapter7.html">7</A> and <A HREF="chapter8.html">8</A> for details.</P>
<P>The following example shows how to define your own cursor.</P>
<DIV CLASS="example"><P>S(C(I(+5,+10]"XO"))</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>C</B> identifies a cursor control option.</P>
<P><B>I</B> identifies the input cursor suboption.</P>
<P><B>[+5,+10]</B> selects the coordinate for the origin of the cursor.</P>
<P><B>" "</B> enclose the character mask.</P>
<TABLE>
<TBODY>
<TR VALIGN="TOP">
<TD><B>X</B>&nbsp;&nbsp;&nbsp;</TD>
<TD>is displayed in the foreground color. This character can be any
displayable character, from a built-in or loaded character set (<A HREF="chapter8.html">Chapter 8</A>).</TD>
</TR>
<TR VALIGN="TOP">
<TD><B>O</B>&nbsp;&nbsp;&nbsp;</TD>
<TD>is displayed in the background color. This character can be any displayable
character from a built-in or loaded character set (<A HREF="chapter8.html">Chapter 8</A>).</TD>
</TR>
</TBODY>
</TABLE></DIV>
<P>Resulting cursor: <IMG SRC="xo-cursor.png" ALT="X and O overlaid"></P>
<H2 ID="S2.10">Display Graphics Page &#8211; P</H2>
<P>This option selects which of two possible graphics pages the terminal displays.
This option is only useful when you run a single session on the terminal, because
only a single session has two graphics pages available. When you use
dual sessions, each session has only one graphics page available.</P>
<DIV CLASS="example"><P>S(P&lt;0 or 1&gt;)</P></DIV>
<P>where</P>
<DIV CLASS="example"><P><B>P</B> identifies the display page option.</P>
<P><B>0</B> displays the first graphics page (default).</P>
<P><B>1</B> displays the second graphics page.</P></DIV>
<H2 ID="S2.11">Screen Control Command Summary</H2>
<P><A HREF="#T2-4">Table 2-4</A> is a summary of the <B>S</B> command options, including any default
values.</P>
<TABLE ID="T2-4" CLASS="summarytable" FRAME="VOID" RULES="GROUPS" CELLSPACING="0" CELLPADDING="4">
<CAPTION>Table 2-4 Screen Control Command Summary</CAPTION>
<COL SPAN="2" WIDTH="25%">
<COL WIDTH="50%">
<THEAD>
<TR VALIGN="BOTTOM">
<TH>Option</TH>
<TH>Default</TH>
<TH>Description</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN="TOP">
<TD>(A[X1,Y1][X2,Y2])</TD>
<TD>[0,0][799,479]</TD>
<TD><P><STRONG>Display addressing</STRONG><BR>
Lets you define screen addressing that uses a different size or orientation than the default VT300 screen.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>[X,Y]</TD>
<TD>[0,0]</TD>
<TD><P><STRONG>Scrolling with relative X and Y values</STRONG><BR>
Uses an [X,Y] value to scroll screen data in the bitmap. Does not change the coordinate system.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>&lt;PV number&gt;</TD>
<TD>None</TD>
<TD><P><STRONG>Scrolling with PV offset</STRONG><BR>
Uses a &lt;PV number&gt; to scroll screen data in the bitmap. Does not change the coordinate system.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(H)</TD>
<TD>None</TD>
<TD><P><STRONG>Print complete screen</STRONG></P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(H[X,Y][X,Y])</TD>
<TD>[0,0][799,479]</TD>
<TD><P><STRONG>Print defined area (two positions)</STRONG><BR>
Uses two [X,Y] screen coordinates to define opposite corners of the area to print.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(H[X,Y])</TD>
<TD>[0,0]</TD>
<TD><P><STRONG>Print defined area (one position)</STRONG><BR>
Uses an [X,Y] screen coordinate and the current cursor position to define opposite corners of the area to print.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(H(P[X,Y]))</TD>
<TD>[50,0]</TD>
<TD><P><STRONG>Print offset suboption</STRONG><BR>
Defines where the upper-left corner of an image will print, using a relative offset from the current printhead location.</P>
<P>The default at power-up is [50,0], until you define a new value. Any new value remains in effect until redefined.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(M&lt;n&gt;(&lt;Lvalue&gt;))</TD>
<TD><TABLE>
<THEAD>
<TR>
<TH COLSPAN="2">VT330</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD>0(L0)</TD>
<TD>1(L25)</TD>
</TR>
<TR>
<TD>2(L50)</TD>
<TD>3(L75)</TD>
</TR>
</TBODY>
</TABLE>
<TABLE>
<THEAD>
<TR>
<TH COLSPAN="2">VT340</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD>0(L0)</TD>
<TD>1(L4)</TD>
</TR>
<TR>
<TD>2(L10)</TD>
<TD>3(L17)</TD>
</TR>
<TR>
<TD>4(L24)</TD>
<TD>5(L30)</TD>
</TR>
<TR>
<TD>6(L37)</TD>
<TD>7(L44)</TD>
</TR>
<TR>
<TD>8(L50)</TD>
<TD>9(L57)</TD>
</TR>
<TR>
<TD>10(L64)</TD>
<TD>11(L70)</TD>
</TR>
<TR>
<TD>12(L77)</TD>
<TD>13(L84)</TD>
</TR>
<TR>
<TD>14(L90)</TD>
<TD>15(L97)</TD>
</TR>
</TBODY>
</TABLE></TD>
<TD><P><STRONG>Output mapping values (monochrome)</STRONG><BR>
Defines the monochrome intensity value to store in the selected &lt;n&gt; output map location.
You can change the value of one or more locations with a single command.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(M&lt;n&gt;(&lt;RGB&gt;))</TD>
<TD><TABLE>
<TBODY>
<TR>
<TD>0(AD)</TD>
<TD>1(AB)</TD>
</TR>
<TR>
<TD>2(AR)</TD>
<TD>3(AG)</TD>
</TR>
<TR>
<TD>4(AM)</TD>
<TD>5(AC)</TD>
</TR>
<TR>
<TD>6(AY)</TD>
<TD>7(AD)</TD>
</TR>
<TR>
<TD>8(AW)</TD>
<TD>9(AB)</TD>
</TR>
<TR>
<TD>10(AR)</TD>
<TD>11(AG)</TD>
</TR>
<TR>
<TD>12(AM)</TD>
<TD>13(AC)</TD>
</TR>
<TR>
<TD>14(AY)</TD>
<TD>15(AD)</TD>
</TR>
</TBODY>
</TABLE></TD>
<TD><P><STRONG>Output mapping values (RGB color)</STRONG><BR>
Defines the RGB color to store in the selected &lt;n&gt; output map. You can change the value of one or more locations with
a single command.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(M&lt;n&gt;(HLS))</TD>
<TD>0(AL0)<BR>1(AH0L50S60)<BR>2(AH120L46S72)<BR>3(AH240L50S60)<BR>4(AH60L50S60)<BR>5(AH300L50S60)<BR>
6(AH180L50S60)<BR>7(AH0L53S0)<BR>8(AH0L26S0)<BR>9(AH0L46S29)<BR>10(AH120L43S29)<BR>11(AH240L46S29)<BR>12(AH60L46S29)<BR>13(AH300L46S29)<BR>14(AH180L46S29)<BR>15(AH0L80S0)</TD>
<TD><P><STRONG>Output mapping values (HLS color)</STRONG><BR>
Defines the HLS color to store in the selected &lt;n&gt; output map location. You can change the
value of one or more locations with a single command. Default values are HLS values for default RGB values.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(I&lt;n&gt;)</TD>
<TD>0</TD>
<TD><P><STRONG>Background intensity (monochrome)</STRONG><BR>
Selects output map location &lt;n&gt; for the background.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(I(RGB))</TD>
<TD>D</TD>
<TD><P><STRONG>Background intensity (RGB color)</STRONG><BR>
Selects the output map location containing the closest color to the RGB value you specified.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(I(HLS))</TD>
<TD>L0</TD>
<TD><P><STRONG>Background intensity (HLS color)</STRONG><BR>
Selects the output map location containing the closest color to the HLS value you specified.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(T&lt;0 to 32767&gt;)</TD>
<TD>None</TD>
<TD><P><STRONG>Time delay</STRONG><BR>
Selects the number of ticks of the real time clock to count for a delay.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(E)</TD>
<TD>None</TD>
<TD><P><STRONG>Screen erase (current background)</STRONG><BR>
Erases the screen and sets the screen to the current background intensity.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(I&lt;value&gt;,E)</TD>
<TD>0</TD>
<TD><P><STRONG>Screen erase (selected background)</STRONG><BR>
Erases the screen and sets the screen to a selected background &lt;value&gt;.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(W(M&lt;n&gt;&gt;))</TD>
<TD>Current value set in write command</TD>
<TD><P><STRONG>Pixel vector multiplier</STRONG><BR>
Selects a multiplication factor of &lt;n&gt; for each PV value in a scroll command. &lt;n&gt; defines
the number of coordinates affected by each PV value. This is temporary write command, in effect until
the next command key letter.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(C&lt;0 or 1&gt;)</TD>
<TD>1</TD>
<TD><P><STRONG>Graphics cursor on/off</STRONG><BR>
Turns the graphics output cursor of (C0) or on (C1).</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(C1(H&lt;n&gt;))</TD>
<TD>0 (diamond)</TD>
<TD><P><STRONG>Graphics output cursor</STRONG><BR>
H selects the output cursor style.</P>
<P>0 or 1 = diamond.<BR>2 = crosshair.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(C1(I&lt;n&gt;))</TD>
<TD>0 (crosshair)</TD>
<TD><P><STRONG>Graphics input cursor</STRONG><BR>
I selects the input cursor style.</P>
<P>0 or 2 = crosshair.<BR>1 = diamond.<BR>3 = rubber band line.<BR>4 = rubber band rectangle.</P></TD>
</TR>
<TR VALIGN="TOP">
<TD>(P&lt;0 or 1&gt;)</TD>
<TD>0 (first page)</TD>
<TD><P><STRONG>Display graphics page</STRONG><BR>
Selects which graphics page the terminal displays. Useful for single sessions only.</P>
<P>0 = first page.<BR>1 = second page.</P></TD>
</TR>
</TBODY>
</TABLE>
<DIV CLASS="navbar"><HR>
<TABLE WIDTH="100%">
<COL SPAN="3" WIDTH="33%">
<TBODY>
<TR>
<TD ALIGN="LEFT"><A HREF="chapter1.html">Chapter 1</A></TD>
<TD ALIGN="CENTER"><A HREF="contents.html">Contents</A></TD>
<TD ALIGN="RIGHT"><A HREF="chapter3.html">Chapter 3</A></TD>
</TR>
</TBODY>
</TABLE>
<DIV CLASS="navbot">http://vt100.net/docs/vt3xx-gp/chapter2.html</DIV></DIV>
</BODY>
</HTML>
